Skip to content

主力行为指标

接口描述

获取BTC或ETH在特定时间范围内的,因主力动作可能影响到价格趋势的特色指标数据。

使用场景

  • 适用于对BTC和ETH的价格大趋势判断参考
  • 适用于识别主力行为对价格的影响和整体价格趋势走向判断

数据更新频率:每5分钟更新一次

请求URL

  • 方法POST
  • 路径/open/v1/indicator/getPriceMarketList

积分消耗

  • 消耗积分3

前置条件

获取 vsTokenId

条件说明获取方式
已有 vsTokenId直接使用缓存的 vsTokenId,无需重复查询上下文自动提取
未有 vsTokenId调用 POST /vs-token/list 接口获取前置接口调用

请求参数

参数通过请求体(Body)以 JSON 格式传递。

参数名类型必需描述
vsTokenIdlong代币 ID
startTimelong开始时间(毫秒时间戳)
endTimelong结束时间(毫秒时间戳)

响应字段

仅展示 data 数组内每个对象的字段结构:

字段类型实际返回类型描述
vsTokenIdlongstring代币ID
symbolstringstring代币符号
datelonglong时间(毫秒时间戳)
priceMarketTypeintegerinteger价格趋势(1:上涨,2:下跌)

字段业务含义

字段业务含义使用建议
priceMarketType价格趋势标记1表示上涨阶段,2表示下跌阶段,用于判断当前价格走势

枚举值说明

priceMarketType - 价格趋势

含义
1上涨
2下跌

请求示例

json
{
    "vsTokenId": 1,           // 代币 ID
    "startTime": 1770825600000, // 开始时间(时间戳)
    "endTime": 1773417600000    // 结束时间(时间戳)
}

cURL 示例(Linux/macOS)

bash
curl --location --request POST 'http://${host}/api/open/v1/indicator/getPriceMarketList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 1,
    "startTime": 1770825600000,
    "endTime": 1773417600000
}'

cURL 示例(Windows CMD)

cmd
curl --location --request POST "http://${host}/api/open/v1/indicator/getPriceMarketList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 1,    \"startTime\": 1770825600000,    \"endTime\": 1773417600000}"

成功响应示例

json
{
    "code": 200,
    "message": "success",
    "data": [
        {
            "vsTokenId": "1",                     // 代币ID
            "symbol": "BTC",                      // 代币符号
            "date": 1773158400000,                // 时间
            "priceMarketType": 1                   // 价格趋势(1:上涨,2:下跌)
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "date": 1773149400000,
            "priceMarketType": 1
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "date": 1773149100000,
            "priceMarketType": 1
        }
        // ... 更多数据省略
    ],
    "requestId": "xxx-xxx-xxx"
}